“Buy & Sell Online Script” Documentation by “LikeGeo” v1.4


“Buy & Sell Online Script”

Created: 29/06/2013
By: LikeGeo
Last Update: 12/10/2013
Current version: 1.4
Email: contact@zonecoders.com

Thank you for purchasing Buy & Sell Online Script. If you have any questions that are beyond the scope of this help file, please feel free to visit my website ZoneCoders.com or email me via my user page contact form here or you on my website Forum ZoneCoders.com. Thanks so much!


Table of Contents

  1. Requirements
  2. INSTALLATION
  3. Usage
  4. HTML Structure
  5. CSS Files and Structure
  6. PHP variables

 

Requirements - top

Updates for version 1.4

Front site

  • New installation sistem added (Made by ZoneCoders) - NO NEED IONCUBE ANY MORE!
  • Antispam System
  • New item comments system (similar to envato)
  • Item view type changed
  • Item support system added
  • Top 20 items carussel changed listing type
  • Featured author system added
  • Affiliate system added(users can use an refferal link to earn revenue from each salles or deposit made on marketplace)
  • Customers setting page changed
  • Removed item screnshots zip sistem with multi file upload sistem
  • ADS added - If no screenshots will be displayed ADS in place of screnshots
  • Hover item preview image added on items listing
  • Bugs fixed from v1.3

  • Administration

  • Antispam sistem (admin can delete user content and add ip on banned list. Next time when user visit the marketplace will recive an error message)
  • Comments reports sistem added
  • One click user delete on user edit form added
  • Bugs fixed

  • Updates for version 1.3

    Front site

  • Item rating sistem added, the user can rate the item only if they bought that item. The rating sistem is on download page, and also will be show as static on item review page.
  • Author rating sistem added, the user can rate the author only if the user has bought items from that author.
  • Home Page structure and graphics has ben 100% changed
  • Added best salle items on top of the homepage
  • Added Top 20 items on homepage based on item ratings
  • Top 20 items based on jQuery UI carousel
  • Quiq registration added on homepage + chaptcha
  • Welcom box with aditional information for customers after loggin
  • Realtime Latest forum post added on homepage
  • Latest Items added on homepage
  • Featured author box added on homepage based on author ratings. There will be displayed the most rated author, if another author reach the rating, the preview author will be replaced with the new one.
  • Terms of usage link added on footer
  • Default Terms of usage page added
  • My items menu moved from the top menu on sidebar menu

  • Administration

  • Forum Bugs fixed
  • Support ticket bug fixed
  • Settings hompage text changed

  • Updates for version 1.2

    Front site

    Administration

    Updates for version 1.1

    Front site

    Administration

    Forum features


    A) INSTALLATION - top

    -Unzip all files from buy&sell arhive

    -Use an FTP client (filezilla) to upload all files on your public_html(root) folder, be sure that you upload the files on AUTO transfer mode.

    -Be sure that .htaccess whose uploaded and if that file is from Buy & Sell Online Script. Some servers auto generate .htaccess file, so please check if is the corect file.

    ***Instalation wizard***

    NOTE! To use the installation wizard, your server need to support ioncube loaders. If not, just ignore the installation wizard and rename ./includes/sample.inc.config.php to ./includes/inc.config.php. Open inc.config.php with an text editor like Notepad++ and complete all required data Save the file and then inport the data.sql from ./install/sql/data.sql in your database using phpmyadmin.

    Once you edited the config file, go to your phpmyadmin via cPanel and open your database, then inport the sql file from install/sql/sample-sql.sql. Now you can use your website.

    Else, if your server support ioncube loaders,start the installation wizard and ignore the manual installation, open your browser and type: http://yourdomain.com/install

    Follow the instruction and be sure that you enter the corect details on the required filds.

    Once the installation is complete, type on your browser http://yourdomain.com/admin and login as Administrator using admin as username and your password.

    INPORTANT!: Do not forget to set the cron job! Otherwise, the site will not work correctly!.

    To setup the sitemap cron, go to your server cPanel -> Cron Job and add a new cronjob to run once a day,add the Command line:

    		curl http://www.yourdomain.com/crons/cron.sitemap.php?secret=yoursecretkey
    		

    To setup the users cron, go to your server cPanel -> Cron Job and add a new cronjob to run once a day,add the Command line:

    		curl http://www.yourdomain.com/crons/cron.users_data.php?secret=yoursecretkey
    		

    Do not forgot to chenge the secret key from your script administration.


    B) Usage - top

    Languages

    The script comming with 3 custom language: English(by default), French and Romanian (not 100% translated). You can any time add a new language, just open the includes/languages folder, create a new empty language file lang.yourlang.php, then copy the content of lang.en.php and paste in lang.yourlang.php. Edit all the text from the new file in your language, add a new flag for your language into flags folder.

    Setup the new language: Open includes/lang_session.php and add new case for your language. Once you have finished, you need to open includes/footer.php and add your new language there.

    If you want add a new language variable, just open your language file from includes/language/lang.yourlang.php and add a new variable : define('variable_name', 'Variable Translation');. Then just call your variable on your pages by echo like this:

    <php echo variable_name;?>

    Home page text

    To change the homepage text, go to your administration area -> Homepage text and edit the text you need.

    Administration

    To access administration area you need to loggin as administrator, using admin as username and the password that you have chose on setup vizard.

    Membership

    User: This level can only access the website, buy items, send message only to authors, write comments add funds, become an author.

    Reviewer: This level have access same as User level, but he can also access a part of Administration area to aprove or reject items, also can become an author.

    Administrator: This level have full access of the website and for administration area. Be carful when you give this level to an user, he can delete, edit any content of website.

    Trophy

    Bronze Trophy: Users can get this trophy once they sale minimum of amount fixed by admin for Bronze throphy.

    Silver Trophy: Users can get this trophy once they sale minimum of amount fixed by admin for Silver throphy.

    Gold Trophy: Users can get this trophy once they sale minimum of amount fixed by admin for Gold throphy.

    This trophy can help users reputation.

    Deposits tax

    When a user make an deposit, the price will be changed if the admin has fixed a tax for deposits. This tax is becouse the users use your payment procesor and the website services.

    Converter

    Converter: This is an module that help authors to convert the main balance into deposit balance. This is a perfect tool if they need to use tha money from main balance to purchase items.

    Withdraw

    To change the minimum of withdraw, open customers/withdraw.php

    and change the $min_amount value, default is 50.


    C) HTML Structure - top

    The HTML structure of this script is composed of three elements: Header, Content and Footer. To edit or modify the contents of the header, you need to open ./includes/header.php. To edit or modify the content of the footer you need to edit the ./includes/footer.php.

    To change the top Menu you need to open ./includes/menu.php and edit what you need.




    LOGO

    To change the Logo, just open ./includes/header.php, find this line:

    		 <div class="logo"><a href="<?php echo ROOT_URL;?>"><font color="#34B3E6">Buy & Sell</font> <font color="#7EBF11">Online</font></a></div>
    		

    Just change the logo name or if you want to use a logo image, upload your logo image via ftp on ./images/... folder and then replace the old logo line with this line:

    		 <div class="logo"><img src="http://yoursitename.com/images/logofile.png"></div>
    		

    Custom Pages

    To add a new page, go to administration area and click on custom page -> Add new page. You can chose if the page is only for logged in users or for all website visitors.

    Once the page is added, go to page manager and find your new page, on the top you will find a link for your page, copy and create a link in your website to point that page.



    Other customization

    If you would like to edit the color, font, or style of any elements in one of these columns, you need to edit ./css/style.css

    If you find that your new style is not overriding, it is most likely because of a specificity problem. Scroll down in your CSS file and make sure that there isn't a similar style that has more weight.

    So, to ensure that your new styles are applied, make sure that they carry enough "weight" and that there isn't a style lower in the CSS file that is being applied after yours.


    D) CSS Files and Structure - top

    The main CSS file is ./css/style.css. This file contain all website styles and structure. To edit the themes, you need to open css/name_of_theme/jquery-ui-1.10.3.custom.css and edit the colors and styles as you want.

    If you would like to edit a specific section of the site, simply find the appropriate label in the CSS file, and then scroll down until you find the appropriate style that needs to be edited.

    To integrate my script in your one design you need to edit the HTML parts also. You can ask on our forum any question about customization or just open a new topic on Customization and Design section.

    E) Php Variables - top

    Available variables for logged in users:

  • Username: client_data($_SESSION['user_id'],'username');
  • Main Balance: client_data($_SESSION['user_id'],'main_balance');
  • Deposit Balance: client_data($_SESSION['user_id'],'dep_balance');
  • Email: client_data($_SESSION['user_id'],'email');
  • Full Name: client_data($_SESSION['user_id'],'fullname');
  • Address: client_data($_SESSION['user_id'],'address');
  • Country ID: client_data($_SESSION['user_id'],'country');
  • City: client_data($_SESSION['user_id'],'city');
  • Zip code: client_data($_SESSION['user_id'],'zip');
  • Phone nr: client_data($_SESSION['user_id'],'phone');
  • Joined date: date('d-M-Y, h:i', client_data($_SESSION['user_id'],'join'));
  • User status: (client_data($_SESSION['user_id'],'status') == 1 ? 'Active' : 'Inactive');

  • Other variables:

    Website settings:
  • Session User Id: $_SESSION['user_id'];
  • Session Username: $_SESSION['username'];
  • Site title: settings('website_title');
  • Site descripton: settings('website_description');
  • Site keywords: settings('site_key');
  • Admin PayPal email: settings('admin_pp');
  • Paypal Status: (settings('pp_status') == 1 ? 'On' : 'Off');
  • PayPal Sandbox: (settings('pp_sandbox') == true ? 'Yes' : 'No');
  • Admin email: settings('admin_email');
  • Homepage text top: settings('home_top');
  • Admin MoneyBookers email: settings('admin_mb');
  • MoneyBookers Secret key: settings('mb_secret');
  • MoneyBookers Status: (settings('mb_status') == 1 ? 'On' : 'Off');
  • Curency simbol: call_curency_simbol();
  • Curency simbol: call_curency();
  • Use "echo" to display the variable in php tags


    Once again, thank you so much for purchasing Buy & Sell Online script. As I said at the beginning, I'd be glad to help you if you have any questions relating to this script. No guarantees, but I'll do my best to assist. If you have a more general question relating to this script please visit my website ZoneCoders.com and ask for help on our forum or just open an support ticket regarding your issue, or email me at: contact@zonecoders.com.

    P.S: Sory for my bad English :)

    LikeGeo

    Go To Table of Contents